home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / COMM / WTERM110.ARJ / DVLOAD.DOC next >
Text File  |  1992-03-09  |  3KB  |  61 lines
  1. DVLOAD.EXE          CADIS Technical Manual
  2.  
  3. ACKNOWLEDGEMENT
  4.      This program is a public domain program by Rod Murillo which was freely
  5.      available with C source code.  It has been modified to allow an
  6.      "&"parameter to start an application in the background.
  7.  
  8. NAME
  9.      dvload - Load a Desqview application from DOS command line.
  10.  
  11. SYNOPSIS
  12.      dvload [&]PIF-prefix ["parameters"]
  13.  
  14. DESCRIPTION
  15.      DVLOAD is a Desqview-specific program that loads and runs a Desqview
  16.      application as if it were loaded from the "open window" menu in Desqview.
  17.      A Desqview application is defined as an executable program that has a
  18.      Desqview PIF (Program Information File).  These files can normally be
  19.      found in the Desqview default directory, and are created from the "open
  20.      window" menu by selecting "CP" (change program) or "AP" (add program).
  21.      They are of this form: nn-PIF.DVP where nn is the prefix.
  22.  
  23.      DVLOAD searches the command line for a two character PIF prefix, and an
  24.      optional parameter string.  The string must be enclosed in quotes if
  25.      there are any embedded spaces.  The PIF is loaded into memory, and the
  26.      parameter string is mapped into the PIF.  Desqview is then called and
  27.      loading takes place.  Control will return to DVLOAD when the loaded
  28.      application finishes execution, which then exits.  If an "&" is placed
  29.      in front of the PIF prefix, the process will start up in background.
  30.  
  31. EXAMPLES
  32.      dvload wp grunt  (load PIF wp-pif.dvp, and pass the parameter "grunt")
  33.      dvload co        (load PIF co-pif.dvp, no paramters)
  34.      dvload &co       (same as above but process is placed in background)
  35.  
  36. DIAGNOSTICS
  37.      DVLOAD returns with the following errorlevel codes:
  38.  
  39.           errorlevel
  40.                0   no errors.  application started under DV.
  41.                1   desqview is not loaded.
  42.                2   error on opening PIF file.
  43.                3   error on reading PIF file.
  44.                4   error on starting application.
  45.                5   error in command line options.
  46.  
  47. NOTES
  48.      Because of Desqview limitations, the parameter string is limited to 63
  49.      characters.  Any information after position 63 is ignored.
  50.  
  51.      The PIF files are searched for in c:\dv.  This is coded into the program.
  52.  
  53.      The API library only seems to work reliably under Desqview 2.01.  Thus
  54.      this program is only recomended to run under 2.10
  55.  
  56.      The .exe was compiled under Turbo C 1.5
  57.  
  58. BUGS
  59.      PIF prefixes must be 2 characters.  Unknown results if only one character
  60.      is passed to the program.
  61.